home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / expand.z / expand
Encoding:
Text File  |  2002-10-03  |  6.2 KB  |  199 lines
  1.  
  2.  
  3.  
  4. eeeexxxxppppaaaannnndddd((((1111))))                                                            eeeexxxxppppaaaannnndddd((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      expand - convert tabs to spaces
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      eeeexxxxppppaaaannnndddd [ -t tablist ] [ file ]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The _e_x_p_a_n_d utility writes files or the standard input to the standard
  16.      output with tab characters replaced with one or more space characters
  17.      needed to pad to the next tab stop. Any backspace characters will be
  18.      copied to the output and cause the column position count for tab stop
  19.      calculations to be decremented; the column position count will not be
  20.      decremented below zero.
  21.  
  22. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  23.      _e_x_p_a_n_d may be used with the following options:
  24.  
  25.      ----tttt _t_a_b_l_i_s_t
  26.           Specify the tab stops. The argument tablist must consist of a single
  27.           positive decimal integer or multiple positive decimal integers,
  28.           separated by blank characters or commas, in ascending order. If a
  29.           single number is given, tabs will be set _t_a_b_l_i_s_t column positions
  30.           apart instead of the default 8.  If multiple numbers are given, the
  31.           tabs will be set at those specific column positions.
  32.  
  33.           Each tab-stop position _N must be an integer value greater than zero,
  34.           and the list must be in strictly ascending order. This is taken to
  35.           mean that, from the start of a line of output, tabbing to position _N
  36.           causes the next character be in the (_N+_1)_t_h column position on that
  37.           line.
  38.  
  39.           In the event of _e_x_p_a_n_d having to process a tab character at a
  40.           position beyond the last of those specified in a multiple tab-stop
  41.           list, the tab character is replaced by a single space character in
  42.           the output.
  43.  
  44. OOOOPPPPEEEERRRRAAAANNNNDDDDSSSS
  45.      The following operand is supported:
  46.  
  47.      -t _f_i_l_e   The pathname of a text file to be used as input.
  48.  
  49. SSSSTTTTDDDDIIIINNNN
  50.      See IIIINNNNPPPPUUUUTTTT FFFFIIIILLLLEEEESSSS....
  51.  
  52. IIIINNNNPPPPUUUUTTTT FFFFIIIILLLLEEEESSSS
  53.      Input files must be text files.
  54.  
  55. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT VVVVAAAARRRRIIIIAAAABBBBLLLLEEEESSSS
  56.      The following environment variables affect the execution of _e_x_p_a_n_d:
  57.  
  58.      _L_A_N_G      Provide a default value for the internationalisation variables
  59.      that are unset or null. If _L_A_N_G is unset or null, the corresponding value
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. eeeexxxxppppaaaannnndddd((((1111))))                                                            eeeexxxxppppaaaannnndddd((((1111))))
  71.  
  72.  
  73.  
  74.      from the implementation-specific default locale will be used. If any of
  75.      the internationalisation variables contains an invalid setting, the
  76.      utility will behave as if none of the variables had been defined.
  77.  
  78.      _L_C__A_L_L      If set to a non-empty string value, override the values of
  79.      all the other internationalisation variables.
  80.  
  81.      _L_C__C_T_Y_P_E      Determine the locale for the interpretation of sequences of
  82.      bytes of text data as characters (for example, single- as opposed to
  83.      multi-byte characters in arguments and input files), the processing of
  84.      tab and space characters, and for the determination of the width in
  85.      column positions each character would occupy on a constant-width font
  86.      output device.
  87.  
  88.      _L_C__M_E_S_S_A_G_E_S      Determine the locale that should be used to affect the
  89.      format and contents of diagnostic messages written to standard error.
  90.  
  91.  
  92. AAAASSSSYYYYNNNNCCCCHHHHRRRROOOONNNNOOOOUUUUSSSS EEEEVVVVEEEENNNNTTTTSSSS
  93.      Default.
  94.  
  95.  
  96. SSSSTTTTDDDDOOOOUUUUTTTT
  97.      The standard output is equivalent to the input files with tab characters
  98.      converted into the appropriate number of space characters.
  99.  
  100.  
  101. SSSSTTTTDDDDEEEERRRRRRRR
  102.      Used only for diagnostic messages.
  103.  
  104.  
  105. OOOOUUUUTTTTPPPPUUUUTTTT FFFFIIIILLLLEEEESSSS
  106.      None.
  107.  
  108.  
  109. EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  110.      None.
  111.  
  112.  
  113. EEEEXXXXIIIITTTT SSSSTTTTAAAATTTTUUUUSSSS
  114.      The following exit values are returned:
  115.  
  116.      0 Successful completion.
  117.  
  118.      >0 An error occurred.
  119.  
  120.  
  121. CCCCOOOONNNNSSSSEEEEQQQQUUUUEEEENNNNCCCCEEEESSSS OOOOFFFF EEEERRRRRRRROOOORRRRSSSS
  122.      The _e_x_p_a_n_d utility will terminate with an error message and non-zero exit
  123.      status upon encountering difficulties accessing one of the _f_i_l_e operands.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. eeeexxxxppppaaaannnndddd((((1111))))                                                            eeeexxxxppppaaaannnndddd((((1111))))
  137.  
  138.  
  139.  
  140. AAAAPPPPPPPPLLLLIIIICCCCAAAATTTTIIIIOOOONNNN UUUUSSSSAAAAGGGGEEEE
  141.      None.
  142.  
  143.  
  144. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  145.      None.
  146.  
  147.  
  148. FFFFUUUUTTTTUUUURRRREEEE DDDDIIIIRRRREEEECCCCTTTTIIIIOOOONNNNSSSS
  149.      None.
  150.  
  151.  
  152. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  153.      _t_a_b_s, _u_n_e_x_p_a_n_d
  154.  
  155.  
  156. CCCCHHHHAAAANNNNGGGGEEEE HHHHIIIISSSSTTTTOOOORRRRYYYY
  157.      First released in Issue 4.
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.